前言

在搭建博客的过程中参考了一些其他作者的资料，也遇到了一些小问题，所幸在Google之后找到了解决方案，感谢这些作者们，于是我决定把搭建的全过程记录下来，希望能够给大家提供一些参考。

准备工作

注册Github账号

访问：http://www.github.com/

配置SSH keys和添加SSH Key到Github

1.终端中输入下列指令，生成密钥，一路回车

$ ssh-keygen

出现下面所示则表示密钥成功生成

Your identification has been saved in /Users/taochen/.ssh/id_rsa.
Your public key has been saved in /Users/taochen/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:ckScuB/7NjJDT0OUbtm1dp4lUiPr5mcV3xJqVzcR9Ng taochen@TC-MacBookpro.local
The key's randomart image is:
+---[RSA 2048]----+
|       o.. .  .o.|
|      ..o o . ++.|
|       ..o o =.oE|
|      ... = + =o=|
|      ..S= . + *O|
|       o+ o = o.=|
|       . + = . o |
|        + = . o  |
|         = . o   |
+----[SHA256]-----+
TC-MacBookpro:~ taochen$

2.密钥生成以后，存放在~/.ssh目录中

$ ls ~/.ssh

1 2	$ ls ~/.ssh id_rsa id_rsa.pub

$ cat ~/.ssh/id_rsa.pub

1
2

$ cat ~/.ssh/id_rsa.pub 
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDA9vWA+ToVHjvMV+9LerF7hdHawqh3ls8OVSsYNfP2ppLS4/w47cWKOR+9Dv6cgqJLstDt7mgnbcpFcztLYZKBy1ZPBgOA1tYtxDIA2pDMIKsYd9M7UosgavCMgBg0dlO1y+xUhnyShqduDHblCCUjM9D+rB6HipeNQWZLWNZ39anPvjTp9ZizdDTtPYi7zaB/fcUatqxeHkFUjHm6WYaC/gQrYsqj1LAonQCdfdgHL8VZg2sXTxl+AOZfX1ZGTs3qXFAoUkDWaMQKC3UNTNrUC9MwNcs/+cLecaDMf+5BBxI71xRP+JLvAy1mTeux2vk0d9FyLU7et9d taochen@TC-MacBookpro.local

复制出密钥内容

3.到github中添加密钥（把ssh的公钥给github）

登陆github系统。点击右上角的 Account Settings—>SSH and GPG keys —>New SSH key —>填写Title和Key

4.最后，点击Add SSH key确认添加密钥

使用Github Pages建立博客

github上建立仓库

1.在github首页，点击页面中的Start a project

2.输入仓库名：username.github.io (username指你的github用户名，这里以taylor-chan为例)

注：Github Pages的Repository的名字是有规定格式的，否则Github无法识别这个Repository是你的Github账户的Pages

在本地创建名为`blog`的文件夹，并初始化为git仓库

(文件夹名可随意，此处以blog为例)

1
2
3

$ mkdir blog
$ cd blog
$ git init

这里用于存放建立blog的原始文件

Hexo模板引擎

Hexo是什么

Hexo是一个简单、快速、强大的博客发布工具，支持Markdown格式，具体详见官方介绍。

安装Hexo

1	$ npm install -g hexo

初始化Hexo

1	$ hexo init

Hexo引擎随后会自动在目标文件夹里生成建立blog所需的所有文件。

更换Hexo主题

复制主题

可以去Hexo官网寻找你喜欢的主题，这里我们以选用Apollo主题为例:
1.先进入blog下面的themes文件夹

1 2	➜ blog git:(master) ✗ cd themes ➜ themes git:(master) ✗

2.将主题的仓库代码克隆到本地

1	$ git clone https://github.com/pinggod/hexo-theme-apollo.git apllo

启用主题

1.在编辑器中打开blog文件夹
2.修改_config.yml配置文件中的theme配置项为apollo
3._config.yml配置文件中的title和author等信息可根据自己的需要进行更改

验证主题

首先启动 Hexo 本地站点

$ hexo s

在服务启动的过程中，注意观察命令行输出是否有任何异常信息，当命令行输出中提示：

1	INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

此时即可使用浏览器访问 http://localhost:4000 ，以验证主题是否正确启用。

若遇到主题无法启用，可能还需要安装某些theme插件

若未遇到主题无法启用的问题，本步骤请忽略
具体请参考主题的详细介绍页面，如Apollo主题就需要安装执行下面的指令：

1	$ npm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive

配置deploy

在_config.yml文件中配置deploy（username以taylor-chan为例,请自行替换为自己的username）

1
2
3

type: git
repository: git@github.com:taylor-chan/taylor-chan.github.io.git
branch: master

写博客

输入hexo new postName指令即可，postName为你的新博文名称，hexo会在 blog/source/_posts/目录下建立新的.md文件，写入Markdown格式博文即可。

写完博客之后，可以同样先输入命令hexo s启动本地服务，进行文章预览调试。

推送到Github

在本地预览无误后，可以执行推送到github的命令：

1 2	$ hexo g $ hexo d

遇到“Deployer not found: github”时的解决办法

若未遇到此问题，本步骤请忽略

1	$ npm install hexo-deployer-git --save

访问博客

在以上步骤都成功完整后，浏览器访问链接 https://{username}.github.io 即可。
e.g. : https://taylor-chan.github.io

前言